32 bit Api Dll Contents:Windows Information and Control

First of 10 dlls to provide easy access to the windows API.

Finally an inline dll which harnesses the power of 32Bit Operating System. There will be 10 separate dlls ranging from managing windows, to communicating across processes. If you are using visual basic these dlls can give your programs the power of c++ with Visual Basic.

Beta Release

The contents of the download: Setup.lst You may download and try the beta release of this dll here. (api321b.zip)
The dll will present a message on December 31, 1996 and after reminding you to download the final release.
Report any bugs found to tagraham@alpha.wcoil.com
Pricing will be announced upon final release.

API32-1 Library Function Index

ParseRetStr(ReturnedFromAPIClass, ItemNum)

Use: To extract values from the functions that return strings.

API Equalivent:
None

Arguments:
ReturnedFromAPI
A string containg the results from the API Call retruning strings.
ItemNum
An integer directing the function on which item in the string to extract.

Returns:
A variant that is usually a Long Integer

AdjWinRect(RLeft, RTop, RRight, RBottom, WinStyle, WinHasMenu)

Use: Calculates the window size needed for a rectangle using specified style:

API Equalivent:
AdjustWindowRect

Arguments:
RLeft
Left coordinate of rectangle as a LONG integer.
RTop
Top coordinate of rectangle as a LONG integer.
RRight
Right coordinate of rectangle as a LONG integer.
RBottom
Bottom coordinate of rectangle as a LONG integer.
WinStyle
Style of window as a LONG integer.
WinHasMenu
A boolean (True/False).

Returns:
This function returns a string containing "0" if the functon is not successful.
If the function is successful a string in the following format is returned:
"Count Left Top Right Bottom" OR
"4 0 0 100 300"
Use the ParseRetStr function to extract the values.

AnyPopups()

Use: To check if any popup windows exist on the screen.

API Equalivent:
AnyPopup

Arguments:
NONE

Returns:
This function returns a boolean True if a popup is found

ArrangeIconicWin(ParentWinHandle)

Use: Arrange minimized children of a parent window.

API Equalivent:
ArrangeIconicWindows

Arguments:
ParentWinHandle
Handle of parentwindow as a Long.

Returns:
The height of the Icon Row otherwise 0 as a Long

AttThreadInput(AttachThreadIdenty, AttachToThreadIdenty, Attach)

Use: Allows related input functions to share queues like Wins16.

API Equalivent:
AttachThreadInput

Arguments:
AttachThreadIdenty
Thread identy of the thread to attach as a LONG integer.
AttachToThreadIdenty
Thread identy of the thread to attach as a LONG integer.
Attach
True to attach, False to detach as a Boolean.

Returns:
Boolean that is True if successful.

BringWinToTop(WinHandle)

Use: To bring window(hwnd) to the top.

API Equalivent:
BringWindowToTop

Arguments:
WinHandle
Handle of the window to bring to the top as a Long.

Returns:
This function returns True if successful.

BegDeferWinPos(NumberOfWindows)

Use: Begins process of building new window positions. See EndDeferWinPos.

API Equalivent:
BeginDeferWindowPos

Arguments:
NumberOfWindows
Initial number of windows in structure. Value automaticaly updates if necessary.

Returns:
0 if not completed successfully. Handle to structure if successful as a Long

ChildWinFromPoint(ParentHandle, X_InPixels, Y_InPixels)

Use: Returns the handle of a child window.

API Equalivent:
ChildWindowFromPoint

Arguments:
ParentHandle
Handle of the parent window as a Long.
X_InPixels
x position in pixels as a Long.
Y_InPixels
y position in pixels as a Long.

Returns:
Handle of the first child window found as a Long.

ClientToScrn(HandleOfWin, x, y)

Use: Find Screen coordinates given client coorddinates of the window.

API Equalivent:
ClientToScreen

Arguments:
HandleOfWin
Handle of the client window as a Long.
x
x point of client window.
y
y point of client window.

Returns:
A string containing the x and y values in screen coordinates.
Use StringParseReturn function to extract individual values.

CloseWin(WHandle)

Use: To minimize a window. Function does not destroy the window.

API Equalivent:
CloseWindow

Arguments:
WHandle
Handle of the window to close as a Long.

Returns:
True if successful as a boolean.

DeferWinPos(hPosInfo, PosHwnd, InsAftHwnd, x, y, cx, cy, flags)

Use: Specify a new window position. See also: BegDefWinPos, EndDefWinPos.

API Equalivent:
DeferWindowPosition

Arguments:
hPosInfo
Handle returned from BegDefWinPos as a Long..
PosHwnd
Handle of window to position as a Long.
InsAftHwnd
Handle of window to place window after as a Long. See HWND_ Properties.
x
New x coordinate of the window as a Long.
y
New y coordinate of the window as a Long.
cx
New window width as a Long.
cy
New window height as a Long..
flags
A long integer. See SWP_ Properties.

Returns:
Handle to position update info on success. 0 on failure or error.

DrawAnimtedRects(WinHandle, idAni, Fleft, Ftop, Fright, Fbottom, Tleft, Ttop, Tright, Tbottom)

Use: Draws animated rectangles from F to T rectangles.

API Equalivent:
DrawAnimatedRects

Arguments:
WinHandle
Handle to window to draw the rectangle in as a Long.
idAni
Use 0 for Win95.
Fleft, Ftop, Fright, Fbottom
From rectangle coordinates as Longs.
Tleft, Ttop, Tright, Tbottom
To rectangle coordinates as Longs.

Returns:
A boolean that is True on success.

EnableWin(WHandle, Enabled)

Use: Enables or disables all mouse and keyboard input to window specified.

API Equalivent:
EnableWindow

Arguments:
WHandle
Handle of window to affect as a Long.
Enabled
Boolean: Set True to enable, False to disable.

Returns:
Boolean: True on success.

endDeferWinPos(hWINPosition)

Use: Updates windows used in DefWinPos

API Equalivent:
EndDeferWindowPos

Arguments:
hWINPosition
Handle of most recent called by DeferWinPos.

Returns:
Boolean: True if successful.

FindWinByClassname(clsname)

Use: To find the handle of a window.

API Equalivent:
FindWindow
Arguments:
clsname
String containing the class name of the window to find.

Returns:
The handle of the window found as a long on success, otherwise 0.

FindWinByTitle(Titlename)

Use: To find the handle of a window.

API Equalivent:
FindWindow

Arguments:
Titlename
String containing theTitle(Caption) of the window to find.

Returns:
The handle of the window found as a long on success, otherwise 0.

FlashWin(WinHandle, Switch)

Use: Titlebar flashes on or off as determined by Switch.

API Equalivent:
FlashWindow

Arguments:
WinHandle
Handle of the window to flash as a long.
Switch
Set true to flash on false to flash off as a boolean.

Returns:
True on success as a boolean.

GetActiveWin()

Use: To find the handle of current active window.

API Equalivent:
GetActiveWindow
Arguments:
None

Returns:
Handle of active window as a long.

GetCappture()

Use: Get handle of current input thread and mouse capture.

API Equalivent:
GetCapture

Arguments:
None

Returns:
Handle of window that has capture as a long.

GetClientRectangle(WinHandle)

Use: Find the size of Window rectangle.

API Equalivent:
GetClientRect

Arguments:
WinHandle
Handle of the window to check as a long.

Returns:
Rectangle coordinates as a string
Use ParseRetStr to extract individual values.
Format Of String: "Count Left Top Right Bottom"
Example Return: " 4 0 0 400 500"

GetClsInfo(WinHandle, clsname)

Use: Return information about specified class.

API Equalivent:
GetClassInfo
Arguments:
WinHandle
Handle of the window to check as a long.
clsname
Name of class as a string.

Returns:
Class information as a string
Use ParseRetStr to extract individual values.
Format Of String: "Count Process clsextra wndextra hinstance hcursor hbrbackground menuname classname"

GetClsName(WinHandle)

Use: Return classname of a window.

API Equalivent:
GetClassName

Arguments:
WinHandle
Handle of the window to check as a long.

Returns:
Class name as a string

GetDeskTopWin()

Use: Get handle representing the entire screen.

API Equalivent:
GetDeskTopWindow

Arguments:
None

Returns:
Handle of the desktop as a long.

GetFocus_T()

Use: Get handle of window containing current input focus.

API Equalivent:
GetFocus

Arguments:
None

Returns:
Handle of the window as a long.

GetLastActivePopup_T(WHandle)

Use: Return handle of last popup menu.

API Equalivent:
GetLastActivePopup

Arguments:
WHandle
Handle of the Parent window to check as a long.

Returns:
Handle of the popup window if found otherwise 0 as a long.

GetParent_T(WHandle)

Use: Return Parent of a window.

API Equalivent:
GetParent

Arguments:
WHandle
Handle of the Parent window to check as a long.

Returns:
Handle of the Parent window if found otherwise 0 as a long.

GetTopWin(WHandle)

Use: Return handle of top child window.

API Equalivent:
GetTopWindow
Arguments:
WHandle
Handle of the Parent window to check as a long.

Returns:
Handle of the popup window if found otherwise 0 as a long.

GetWINContextHelpID(WHandle)

Use: To find accociated ID of a window.

API Equalivent:
GetWindowContextHelpID

Arguments:
WHandle
Handle of the window to check as a long.

Returns:
help context ID if found otherwise 0 as a long.

GetWINPlacement(WHandle)

Use: Obtain info about a window.

API Equalivent:
GetWindowPlacement

Arguments:
WHandle
Handle of the window to check as a long.

Returns:
A string containing information about the window.
Format:
"count length flags showcmd MinX MinY MaxX MaxY Left Top Right Bottom"
Use ParseRetStr to extract individual values.

GetWINRECT(WHandle)

Use: Returns the rectangle coordinates of the window

API Equalivent:
GetWindowRect

Arguments:
WHandle
Handle of the window to check as a long.

Returns:
A string containing information about the window.
Format:
"count Left Top Right Bottom"
Use ParseRetStr to extract individual values.

GetWINText(WHandle)

Use: Returns the title (Caption) of the window.

API Equalivent:
GetWindowText

Arguments:
WHandle
Handle of the window to check as a long.

Returns:
A string containing the window text.

GetWINTextLength(WHandle)

Use: Returns the title (Caption) text length of the window.

API Equalivent:
GetWindowTextLength

Arguments:
WHandle
Handle of the window to check as a long.

Returns:
A long containing the window text length.

InflateRectangle(Left, Top, Right, Bottom, x, y)
Use: To increase or decrease the size of the rectangle.
Negitive values reduce while positive values increase size.
Changes in x and y will be twice amount specified.

API Equalivent:
InflateRect

Arguments:
Left, Top, Right, Bottom
Coordinates of rectangle as Long integers.
x
Inflate width as a long.
y
Inflate height as a long.

Returns:
A boolean which is true if function is successful.

InvalidateRectangle(WHandle, left, top, right, bottom, EraseIt)

Use: Invalidate all or part of the client area of a window.

API Equalivent:
InvalidateRect

Arguments:
WHandle
Handle to window to invalidate as a Long.
left, top, right, bottom
Rectangle coordinates as Longs.

Returns:
A boolean that is True on success.

isChild_T(ParentHandle, testHandle)

Use: To determine if a window is a child of another.

API Equalivent:
IsChild

Arguments:
ParentHandle
Handle to window to test as parent as a Long.
testHandle
Handle of window to test as child as a Long.

Returns:
A boolean that is True if the window is a child.

isIconic_T(WHandle)

Use: Check if a window is minimized.

API Equalivent:
IsIconic

Arguments:
WHandle
Handle of window to test as a Long.

Returns:
A boolean that is True if window is minimized.

isRectEmpty_T(left, top, right, bottom)

Use: Check if a rectangle is empty..

API Equalivent:
IsRectEmpty

Arguments:
left, top, right, bottom
Rectangle coordinates as Longs.

Returns:
A boolean that is True is rectangle is empty.

isWindow_T(WHandle)

Use: Check if a window handle is valid.

API Equalivent:
IsWindow

Arguments:
WHandle
Handle to window to test as a Long.

Returns:
A boolean that is True if window handle is valid.

isWindowEnabled_T(WHandle)

Use: To check the enabled state of a window.

API Equalivent:
IsWindowEnabled

Arguments:
WHandle
Handle to window to test as a Long.

Returns:
A boolean that is True if window is enabled.

isWindowVisible_T(WHandle)

Use: To check the visible state of a window.

API Equalivent:
IsWindowVisible

Arguments:
WHandle
Handle to window to test as a Long.

Returns:
A boolean that is True if window is visible.

isZoomed_T(WHandle)

Use: To check if the window is maximized.

API Equalivent:
IsZoomed

Arguments:
WHandle
Handle to window to test as a Long.
Returns:
A boolean that is True if window is maximized.

LockWindowUptate_T(WHandle)

Use: Locks the window from being updated

API Equalivent:
LockWindowUpdate

Arguments:
WHandle
Handle to window to lock as a Long.

Returns:
A boolean that is True if window is enabled.
Only one window may be locked at a time.

moveWIN(WHandle, leftPos, topPos, WinWidth, WinHeight, ToRepaint)

Use: To change size and position of window.

API Equalivent:
MoveWindow

Arguments:
WHandle
Handle to window to change as a Long.
leftPos
New left position of window as a Long.
topPos
New top positon of window as a Long.
WinWidth
New window width as a Long.
WinHeight
New window height as a Long.
ToRepaint
Boolean-True if window is to be redrawn.

Returns:
A boolean that is True on success.

offsetRect_T(left, top, right, bottom, x, y))

Use: Move a rectangle by offset values x and y.

API Equalivent:
OffsetRect

Arguments:
left, top, right, bottom
Rectangle coordinates as a long.
x
Horizontal offset as a Long.
y
Vertical offset as a Long.

Returns:
A boolean that is True on success.

OpenIcon_T(WHandle)

Use: To restore and activate a minimized window.

API Equalivent:
OpenIcon

Arguments:
WHandle
Handle to window to open as a Long.

Returns:
A boolean that is True on success.

PtInRect_T(left, top, right, bottom, ptx, pty)

Use: To check if point is located in rectangle.

API Equalivent:
PtInRect

Arguments:
left
Left position of rectangle as a Long.
top
Top position of rectangle as a Long.
right
Right position of rectangle as a Long.
bottom
Bottom position of rectangle as a Long.
ptx
x point value as a long.
pty
y point value as a long.

Returns:
A boolean that is True if point is in rectangle.

RedrawWindow_T(WHandle, left, top, right, bottom, RegionHandle, RedrawType)

Use: Redraws all or part of a window.

API Equalivent:
RedrawWindow

Arguments:
Whandle
Handle of window to redraw as a Long.
left
Left position of rectangle as a Long.
top
Top position of rectangle as a Long.
right
Right position of rectangle as a Long.
bottom
Bottom position of rectangle as a Long.
RegionHandle
Handle to Region as a Long.
RedrawType
Flag to type of redraw as a Long. See RDW properties.

Returns:
A boolean that is True on success

ScreenToClient_T(WHandle, xp, yp)

Use: To find client coordinates, given screen coordinates.

API Equalivent:
ScreenToClient

Arguments:
WHandle
Handle of window to test as a Long.
xp
x screen coordinate as a Long.
yp
y screen coordinate as a Long.

Returns:
A string containign the points in client coordinates.
Format: "count x y"
Use ParseRetStr to extract individual values.

ScrollWindow_T(WHandle, yAmt, xAmt, a-left, a-top, a-right, a-bottom, cr-left, cr-top, cr-right, cr-bottom)

Use: Scrolls a windows client area.
Use update window with this function.

API Equalivent:
ScrollWindow

Arguments:
WHandle
Handle of window to scroll as a Long..
xAmt
Horizontal scroll distance as a Long.
yAmt
Vertical scroll distance as a Long.
a-left, a-top, a-right, a-bottom
Client rectangle coordinates as Longs.
cr-left, cr-top, cr-right, cr-bottom
Clip area only coordinates as Longs.
Scroll this area only.

Returns:
A boolean that is True on success.

SetActiveWindow_T(WHandle)

Use: To check if point is located in rectangle.

API Equalivent:
SetActiveWindow

Arguments:
WHandle
Handle of window to set as active.

Returns:
A handle of the previous active window as a long.

SetCapture_T(WHandle)

Use: Sets mouse capture to window.

API Equalivent:
SetCapture

Arguments:
WHandle
Handle of window to set capture as a Long.

Returns:
A handle of the previous captured window as a long.

SetFocusAPI_T(WHandle)

Use: To set input focus to a window.

API Equalivent:
SetFocusAPI

Arguments:
WHandle
Handle of window to set as focused as a Long.

Returns:
A handle of the previous focused window as a long.

SetForeGroundWindow_T(WHandle)

Use: To bring window from background to top.

API Equalivent:
SetForeGroundWindow

Arguments:
WHandle
Handle of window to bring foreward as a Long.

Returns:
Boolean that is true on success.

SetParent_T(ChildWinHandle, NewParentWin)

Use: To change a parent for a window or control.

API Equalivent:
SetParent

Arguments:
ChildWinHandle
Handle of child window to change as a Long.
NewParentWin
Handle of window to set as new parent as a Long.

Returns:
Handle of previous parent as a Long.

SetForeGroundWindow_T(WHandle)

Use: To bring window from background to top.

API Equalivent:
SetForeGroundWindow

Arguments:
WHandle
Handle of window to bring foreward as a Long.

Returns:
Boolean that is true on success.

SetWinPos(WHandle, HWInsrtAfter, NewX, NewY, NewWinWidth, NewWinHeight, WinFlags)

Use: Change window state and position info.

API Equalivent:
SetWindowPos

Arguments:
Whandle
Handle of window to set as a Long.
HWInsrtAfter
Handle of window to set after OR see HW properties.
NewX
New Top position of window as a Long.
NewY
New Right position of window as a Long.
NewWinWidth
New width of window as a Long.
NewWinHeight
New height of window as a Long.
WinFlags
Flag to type of set as Long. See SWP properties.

Returns:
A boolean that is True on success

SetWINText_T(WHandle, TxtTOInsert)

Use: Sets the NEw Caption of a window.

API Equalivent:
SetWindowText

Arguments:
Whandle
Handle of window to change as a Long.
TxtTOInsert
New caption of window as a string.

Returns:
A boolean that is True on success

ShowOwnedPopups_T(ParentHandle, ShowTrueHideFalse)

Use: To show or hide a popup windows owned by parent..

API Equalivent:
ShowOwnedPopups

Arguments:
ParentHandle
Handle of window to check as a Long.
ShowTrueHideFalse
Boolean true to show false to hide.

Returns:
A boolean that is True on success

ShowWindow_T(WHandle, CommandFlag)

Use: Change window view.

API Equalivent:
ShowWindow

Arguments:
WHandle
Handle of window to change as a Long.
CommandFlag
Long-See SWProperties.

Returns:
A boolean that is True on success.

ShowWindowAsync_T(WHandle, CommandFlag)

Use: Change window view. Unlike ShowWindow_T this function
prevents calling app from hanging if called window is hung.

API Equalivent:
ShowWindowAsync

Arguments:
WHandle
Handle of window to change as a Long.
CommandFlag
Long-See SWProperties.

Returns:
A boolean that is True on success.

SubtractRect_T(Src1Left, Src1Top, Src1Right, Src1Bottom, Src2Left, Src2Top, Src2Right, Src2Bottom)

Use: Subtracts Src2-Src1.

API Equalivent:
SubtractRect

Arguments:
Src1Left, Src1Top, Src1Right, Src1Bottom
Rectangle source 1 coordinates as Longs.
Src2Left, Src2Top, Src2Right, Src2Bottom
Rectangle source 2 coordinates as Longs.

Returns:
A string containing the coordinates of Src2-Src1.
Format: "Count DiffLeft DiffTop DiffRight DiffBottom"
Use ParseRetStr to extract individual values.

UnionRect_T(Src1Left, Src1Top, Src1Right, Src1Bottom, Src2Left, Src2Top, Src2Right, Src2Bottom)

Use: Shows the rectangle containing all points in Union of Src1 and Src2

API Equalivent:
UnionRect

Arguments:
Src1Left, Src1Top, Src1Right, Src1Bottom
Rectangle source 1 coordinates as Longs.
Src2Left, Src2Top, Src2Right, Src2Bottom
Rectangle source 2 coordinates as Longs.

Returns:
A string containing the coordinates of Src2-Src1.
Format: "Count UnionLeft UnionTop UnionRight UnionBottom"
Use ParseRetStr to extract individual values.

UpdateWindow_T(WHandle)

Use: To force an immediate update of a window.

API Equalivent:
UpdateWindow

Arguments:
WHandle
Handle of window to update as a Long.

Returns:
Boolean-True if successful.

ValidateRect_T(WHandle, Left, Top, Right, Bottom)

Use: Validates all or part of a window.

API Equalivent:
ValidateRect

Arguments:
WHandle
Handle of window to validate as Longs.
Left, Top, Right, Bottom
Rectangle source coordinates as Longs.

Returns:
Boolean - True on Success

WindowFromPoint_T(Xpoint, Ypoint)

Use: Gets a window handle from a specified point.

API Equalivent:
WindowFromPoint

Arguments:
Xpoint
X point value as a Long.
Ypoint
Y point value as a Long.

Returns:
Handle of the window containing the point as a long.